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1. 

October 5, 1966 
SYSTEM SUBROUTINES FOR TSS 2.0 — CLASSIFIED LIST 

Note: BRS's marked with 'e' may be used only by programs with executive status. 
ERS's marked with *r ' may be used only with certain restrictions; for 
which see the TSS Reference Manual 

(q) SCHEDULING, FORKS AND PROGRAM INTERACTION 

Ql. P rogrammable Interrupts 

BRS 78 Arm/disarm software interrupts k*l 

79 Cause specified software interrupt k~l 

k$ Determine which software interrupts are armed . k-2 

Q 2 • Control o f th e rubout key 

BRS 90 Select calling fork for termination by next rubout 3-6 

U6e Ignore rubout key 3«6 

^7e Restore response to rubout key 3-6 

26e Skip if rubout waiting (significant only after BRS k6) 3-6 

Q3- Activ a tion of a fork 

BRS 9 Commence execution of a new fork 3-1 

75 Reactivate the closest ancestor fork dismissed by a BRS lh; 
suspend activity in all the ancestor's subsidiary forks 3-7 

76 Restart activity in all forks suspended by a previous 

BRS 75 or 89 3-8 

57 Guarantee 16 ms. continuous computing in this fork 2-3 

^ * I nter r oga ti on_ o f_ a __ fork 

BRS 30 Determine status of a specified subsidiary fork 3-^3 

107 Determine status of all subsidiary forks 3-3 

05 • Temporary suspension of forks 

BRS 1+5 Dismiss calling fork to quantum overflow queue 2-3 

72e Dismiss calling fork to specified queue 2-5 

8l Dismiss calling fork for specified time 6-1 

7 , 4 Dismiss calling fork until BRS 75 or termination in 

any subsidiary fork 3-7 
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75 See § Q3. 3 _ 7 

89 Suspend activity in all forks subsidiary to a given one 3-8 

31 Dismiss calling fork until a specified subsidiary fork 
terminates 00 

106 Dismiss calling fork until any one subsidiary fork terminates 3-3 
109 Dismiss calling fork until a software interrupt occurs or 

it is terminated £_} 

^' Termination of a fork 

BRS 10 Terminate the calling fork, return control to the next 

higher fork 3_6 

22e Terminate all forks subsidiary to the Exec 3.. 7 

32 Terminate a specified subsidiary fork 3,. 3 
108 Terminate all subsidiary forks 3,3 
73 Terminate a specified number of forks 3.6 
77 Terminate all forks suspended by a previous BRS 75 or 89 3-8 
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(F) input/output 



F1 * Direct control of per ipherals 

BRS lx Open device (i.e. reserve and prepare peripheral device 

for I/O) 9-1,9-5 

110 Interrogate file identity 9-7 
2 Close file (i.e. terminate i/o activity and release 

associated device) 9-2 

Close all open files 9-2 

Define open random file as secondary memory 10-2 

Release specified memory from random drum file 10-3 

Release all memory from random drum file - except index block 9-5 

6?e Release specified index block from drum file 9-5 

82 Switch sequential file to input or output 9-2 

87e Read drum file index block into core 9-5 

lOUe Drum- to-core 2K block transfer 5-5 

105 e Core-to-drum 2K block transfer 5-5 

113 Count number of words in drum file 9-5 

llUe Clear W-buffer 9-9 

ll8e Reserve tape unit 9-8 

119e Release tape unit 9-8 
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F2. Handling files_ vjLa_f^le_ names 

BRS 15 Open named file for input 

16 Open named file for output 

17 Open scratch file for input 

18 Open scratch file for output 

19 Delete scratch file 

kP> Set file status word (word 2 of description blcok) 

60 Interrogate file status 

61 Define special-group name 

62 Delete special-group name 

63 Define read-in group name 
Ga Delete read- in group name 

102 Create a subsystem file 

103 Read a subsystem file 



12-3 
12-3 
12-8 
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F '^' j/P operations 

BIO File/memory data block transfer 

WJO Pile/A- register word transfer 

CIO File/A- register character transfer 

DWO Output 1 word from A register to random file 

DWI Input 1 word from random file to A register 

DBO Output data block from memory to random file 

DBI Input data block from random file to memory 

SAS Output 1 word from A register to secondary memory 10 . 

IAS Input 1 word from secondary memory to A register 10- ' J 

CTRL Position file (several options). ^ f>? 
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TELETYPES 



Tl. Linking and attaching 



T2. 



BRS 27 
28 

23 
2k 

25 



Attach teletype to caller 
Release attached teletype 
Link/unlink to specified teletypes 
Unlink from all teletypes 
Set teletype to accept/refuse links 



Input /Output 

BRS 11 Clear TTY input buffer 

Clear TTY output buffer 

Skip if TTY input buffer empty 

Wait until TTY output buffer is empty 

Set 8- level (ASCII) mode for input 

or set echo table and set normal mode for input and output 

Determine current echo table 

Set 8- level mode for output 

Set normal mode for output 



29 
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Ik 
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86 



TCI Input character from controlling TTY 

TCO Output character to controlling TTY 

1ST Input character from specified TTY 

OSTr Output character to specified TTY 

STIr Set character in input buffer of specified TTY 
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' M: MEMORY 

Ml . Private Memory 

BRS k Release pa.ge in current memory 5^2 

121 Release specified pseudo-block 5-3 

120 e Acquire new pseudo-block 5-3 

U3 Read current pseudo relabelling 5-2 

kkr Set current pseudo relabelling 5-2 

ll6e Read "program" relabelling 5-2 

117e Set "program" relabelling 5-2 

122e Make window onto caller's memory 6-2 

5 ) +r Make request for a permanently resident block 5_U 

55r Make/unmake pseudo block permanently resident 5-*+ 

56e Make pseudo block executive type 5-U 

80 Make pseudo block read-only 5-3 

M2. Shared Memory 

BRS 68e Make pseudo-block sharable 5-3 

69e Put sharable information in pseudo block 5-3 

99 Make pseudo blocks sharable and attach a name l6-l 

100 Obtain pseudo-relabelling for accessing named, shared 
information 16-1 

101 Detach name from shared information l6-2 
83 Gall HELP subsystem 

Bk Call HELP maintenance 
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STRBfG PROCESSING 



SI. String I/O 

MS 33 Input string from file . 18-I 

3^ Output message to file 18-1 

35 Output string to file 18. 1 

s2. Hash Table Search 

BRS 5 Search hash table for matching string - no prerecognition 18-1 
37 Search hash table for string augmented by input - with 

prerecognition • 18- 1 

6 Insert new string pointer in hash table 18, 1 

S ^* String mani pulation 

STP Store string pointer lB-1, 19-1 

LDP load string pointer 18-1,19-1 

SKSE Skip if strings equal 18-.1 

SKSG Skip if string greater 18-1 

SU . Character man ipulat ion 

GOT Get character from head of string and increment pointer 18-1 

WCI Write character to tail of string and increment pointer 18-1 

GOD Get character from tail of string and decrement pointer 18-1 

WCD Write character to head of string and decrement pointer lO-l 
WCH Write character to free memory area (with garbage collection) LH- ' 
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NUMBERS 



Nl, Number I/O 

BiRS 36 Output; contents of A register as number with specified radix 17-1 
38 Input integer to A register, interpreting according to 

specified radix 17-1 

52 Jnput floating point decimal no. 19-1 

53 Output floating point decimal no. 19-1 

SIC Convert character string to floating point number 19-1 

ISO Convert floating point number to character string 19-1 



N2. Number arithme tic 

50 Convert floating to fix^ed point no. 

51 Convert fixed to floating point number 
21 Negate floating point number 

FAD Floating point addition 
FSB Floating point subtraction 
FMP Floating point multiplication 
FBV Floating point division 
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6-1 
6-1 

17-1 

6-1 
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-,X|) MISCELLANEOUS 

BRS 20 Read date 
J+2 Read time 

91 Read date and time to string 
88 Read execution time 
Ul Return from I/O subroutine 
llle Return from user-mode BRS g -2 

112e Turn off teletype station y^ 

71 Skip if program has executive status 6_1 

EXSe Execute instruction in system mode 6_ ? 

(ej EXECUTIVE COMMAND BRS's 

BRS 92 Copy file to file lk _ } 

93 Save core on file l^-l 

9k Place file in core 1 ] + _-, 

95 Dump machine on file lU-1 

96 Recover machine from file lU-1 

97 Where is user lh-1 

98 Consult with user ^.k-i 
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Concise Index to BRSs 
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The sum of the numbers in the leftmost column and topmost row 
gives the number of the BRS. 

In the body of the matrix is given the section of this document 
in which the BRS is described. 



